home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Utilities / AF2MacPAF folder / AF2MacPAF.doc < prev    next >
Encoding:
Text File  |  1994-09-29  |  5.9 KB  |  153 lines  |  [TEXT/McPL]
  1.  
  2. AF2MacPAF v 1.0
  3.  
  4.  
  5. This utility which I call AF2MacPAF will take a 
  6. GEDCOM that was created by the LDS "Ancestral File"
  7. program and "clean" it up by translating the little
  8. inconsistencies where Mac PAF and AF disagree on what
  9. a GEDCOM file ought to look like.
  10.  
  11. The program is freeware.  I would like to get it 
  12. into the hands of the Mac PAF 2.11 community the best
  13. way possibly.
  14.  
  15. Note:  If you already have Mac Perl you can save alot
  16. of disk space by keeping only the droplet version.  
  17. If you have no intention of getting Mac Perl, trash
  18. the droplet.  If you need a system 6 version send
  19. me a note.
  20.  
  21. Here is a synopsis of some of the Mac PAF 2.11 errors that this program
  22. will correct:
  23.  
  24.  
  25. If the AF GEDCOM has:      Mac PAF 2.11 does:     with AF2MacPAF
  26.                                                   Mac PAF 2.11 now:
  27.  
  28. 3 or more given names.     drops surname.         reads surname correctly.
  29.  
  30. 4 or more given names.     makes 4th name the     reads surname correctly.
  31.                            surname                attempts to combine short
  32.                                                                                                                                                                              given names so that they
  33.                                                   will fit on the space
  34.                                                   provided.  A note is 
  35.                                                   made of the original name 
  36.                                                   so that the user can 
  37.                                                                                                                                                                                                         override AF2MacPAF's choice.
  38.  
  39.  
  40. name, title or place       truncate name, title   Place a note in the note
  41. part that is longer        or place piece.        field with the correct
  42. than 16 chars.                                    full name, title, or place
  43.                                                   piece.
  44.  
  45. A divorce                  ignores the divorce    reads divorce correctly.
  46.                                                   makes a note in the 
  47.                                                   notefield.
  48.  
  49. a date with funny          ignore the date        Make a note containing 
  50. characters                                        the original date.  Will
  51.                                                   Make some attempt to
  52.                                                   enter part of the date
  53.                 examples:                         information.
  54.  
  55. 1639?                                             ABT 1639 
  56. BET Jun 24 & AUG 7 1955                           BEF 7 AUG 1955 
  57.        
  58.  
  59. Conflicting dates          ignore the date        Make a note containing
  60.                                                   the original date 
  61.                                                   information. 
  62.  
  63. Conflicting LDS ordinance  ignore the data        Use the first date.
  64. information                                       Make a note of all dates.
  65.  
  66.  
  67. Also Mac PAF 2.11 coughs on every individual record from AF, and leaves
  68. a complaint in the listing file saying that it does not know what to
  69. do with the tag "AFN".  By changing this tag to "REFN" we get Mac PAF
  70. to process these records more smoothly, thus making the listing file
  71. easier to read.
  72.  
  73.  
  74.  
  75. To use the program:
  76.  
  77.  1.  When you move your GEDCOM file from the DOS diskette 
  78.       to the Macintosh using “Apple File exchange” make sure
  79.       that you choose “Text Translation....” from the MS-DOS to Mac
  80.       pull down menu.  Note that this is contrary to the 
  81.       instructions that come with Mac PAF.  Do it anyway.  (You are
  82.       now using the AF2MacPAF utility to process that file first 
  83.       instead of Mac PAF.)  When the menu comes up to give you 
  84.       more options, just hit “OK”.
  85.  
  86.  2.  After your GEDCOM has been moved to the Macintosh using
  87.       “Apple File exchange”, just drag and drop onto the AF2MacPAF
  88.       icon.  AF2MacPAF will create a new GEDCOM file with the word
  89.       “clean” appended to the name of the old GEDCOM file.  Mac PAF 2.11
  90.       can read this “clean” file with fewer errors as the name “clean” 
  91.       might suggest.
  92.  
  93.  3.  Now import the clean GEDCOM file using the import facility of 
  94.       the “File” pull-down menu in Mac PAF.  Proceed according to
  95.       the Mac PAF import instructions.
  96.  
  97. About this program.
  98.  
  99. AF2MacPAF is a Mac Perl Script.  Mac Perl is a freeware programming 
  100. language that is particularly good at manipulating strings and things 
  101. like GEDCOM files.  This version of AF2MacPAF 1.0 is a perl runtime 
  102. meaning that it has all of the Mac perl runtime library packed away 
  103. into it, just in case you  do not have Mac Perl, and have no interest 
  104. in getting it.  If you already have Mac Perl then you can save this 
  105. script as a “droplet” and save yourself nearly half a megabyte of 
  106. disk space of library stuff that you already have in Mac Perl.
  107.  
  108. I have chosen to distribute the runtime version instead of the “droplet” 
  109. because I assume that most Mac PAF users will not have Mac Perl.  
  110. (But remember it’s free!)
  111.  
  112. Support:
  113.  
  114. If you experience any problems with this program, or like it, or want 
  115. to swap ideas on making it better I would be happy to hear from you.  
  116. Here are some of the easy ways to get a hold of me using email etc.:
  117.  
  118. Internet: dadams@cray.com
  119. UUNET: uunet!cray!dadams
  120. Packet (Ham Radio) kg0io@tcman.#msp.mn.usa.noam.
  121.  
  122. FAX: (612)-683-5599
  123.  
  124. And finally if all else fails here is my snail mail address:
  125.  
  126. David C. Adams
  127. 1625 Dixon Dr.
  128. St. Paul Park, MN 55071
  129.  
  130. Phone:  (612) 459-9685.
  131.  
  132. Future:
  133.  
  134. Supposedly, there is an upgrade in the works for Mac PAF.  It will correct 
  135. at least one of the bugs that this program fixes, but suspicions are that 
  136. it may well still benefit from the use of a utility like this.
  137.  
  138. I already have some idea about improvements, and you may have others.  
  139.  
  140.  
  141. For more information, or an update of the program, send me a note. (e-mail).
  142. ---   
  143.  
  144.   Sourdough and Ham      AA0PV
  145.  
  146.   David C. Adams     internet:  dadams@cray.com
  147.   Statistician          uunet:     uunet!cray!dadams
  148.   Cray Research Inc.    packet:    kg0io@tcman.#msp.mn.usa.noam
  149.  
  150.    --Old Sourdoughs never die, they just ferment away.
  151.    --Old Hams never die, they just get destinated.
  152.  
  153.